Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Generating Pictures From Movies

GetMoviePosterPict

The GetMoviePosterPict function creates a picture that contains a movie's poster.

pascal PicHandle GetMoviePosterPict (Movie theMovie);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

DESCRIPTION

The GetMoviePosterPict function returns a handle to the picture. Your application must dispose of this picture handle by calling QuickDraw's KillPicture routine. If the function could not create the picture, the returned handle is set to nil.

SPECIAL CONSIDERATIONS

If you have not assigned a poster time for the movie, the Movie Toolbox creates the poster from the movie image that corresponds to a time value of 0.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

Image Compression Manager errors
Memory Manager errors